home *** CD-ROM | disk | FTP | other *** search
/ ASP Advantage 1993 / The Association of Shareware Professionals Advantage CD-ROM 1993.iso / files / homeobby / marnav20 / marnav.doc < prev    next >
Text File  |  1993-06-26  |  28KB  |  527 lines

  1.  
  2.          
  3.          
  4.          
  5.          
  6.          
  7.          
  8.          
  9.          
  10.          
  11.          
  12.          
  13.            _____________________________________________________________
  14.          |                                                             |
  15.          |                                                             |
  16.          |                 -:-:-:   MARNAV   :-:-:-                    |
  17.          |                                                             |
  18.          |        Copyright 1985, 1991, 1993- Edward J. Panner         |
  19.          |                                                             |
  20.          |                     C & E Associates                        |
  21.          |                     119 Placid Drive                        |
  22.          |                     Fort Myers, Fla.                        |
  23.          |                       33919-6104                            |
  24.          |                                                             |
  25.          |                                                             |
  26.          |                                                             |
  27.          |                               _______                       |
  28.          |                          ____|__     |               (R)    |
  29.          |                       --|       |    |-------------------   |
  30.          |                         |   ____|__  |  Association of      |
  31.          |                         |  |       |_|  Shareware           |
  32.          |                         |__|   o   |    Professionals       |
  33.          |                       -----|   |   |---------------------   |
  34.          |                            |___|___|    MEMBER              |
  35.          |                                                             |
  36.          |_____________________________________________________________|
  37.  
  38.  
  39.  
  40.                                      MARNAV
  41.          
  42.                                 C & E ASSOCIATES
  43.                                 119 PLACID DRIVE
  44.                                 FORT MYERS, FLA.
  45.                                      33919
  46.          
  47.                             MARNAV 2.0 DOCUMENTATION
  48.          
  49.                                    SECTION I
  50.          
  51.                                   INTRODUCTION
  52.          
  53.               There is an increasing need for software which will convert
  54.          Latitude/Longitude  data  to  LORAN-C  delay   coordinates   and
  55.          vice-versa  for  the  purpose of adding LORAN-C data to the many
  56.          charts and maps, both land and marine which are published  with-
  57.          out  this  information.  In  addition  to  the  LORAN-Geographic
  58.          conversion, MARNAV also provides  a  means  of  calculating  all
  59.          delays  for a given geographic location thus allowing a shift to
  60.          another slave in the event of technical difficulty or as a means
  61.          of double checking a position.
  62.          
  63.               All  LORAN-C  Chains  for which data is currently available
  64.          have been included in MARNAV. The chain data used  is  based  on
  65.          information  from  the  UNITED STATES COAST GUARD, Department of
  66.          Transportation as published in COMDTINST-M16562.3 (Old CG-462).
  67.          
  68.               The following constants were used for all algorithms in the
  69.          MARNAV Program. Signal propagation velocity used is the velocity
  70.          of light in free space 299,792,458 meters/sec.., sea water  con-
  71.          ductivity  5.0  mhos/meter,  0.01745329251993889 radians/degree.
  72.          All calculations and data in double precision. Calculations nec-
  73.          essarily assume an all water path.
  74.          
  75.               In  addition to LORAN-C Geographic conversions, MARNAV also
  76.          provides the ability to navigation  from  one  pair  of  LORAN-C
  77.          delays  to  another  pair  within  the  same  chain.  In  cruise
  78.          planning, waypoint data is generally listed during the  planning
  79.          stage  and  since  these data are already available it is conve-
  80.          nient  to  use  them  for  calculating  heading   and   distance
  81.          information. In addition it is  also possible to calculate head-
  82.          ing and distance information from Latitude/Longitude data over a
  83.          rhumb  line  course.  These  programs  do  not parallel programs
  84.          available within typical LORAN-C  units  available  today  since
  85.          those  computer  navigation  features  calculate  from  measured
  86.          delays at present position.
  87.          
  88.               Since the Navigation solutions are available it only seemed
  89.          logical  to include a Time/Speed/Distance function. The simplest
  90.          data entry scheme appeared to be the query for each entry with a
  91.          calculated result for the one not entered.
  92.  
  93.  
  94.          MARNAV                   Documentation                   Page- 2
  95.          
  96.  
  97.          C & E Associates has chosen to use the Shareware concept to dis-
  98.          tribute this program. This is good for us in  that  it  contains
  99.          many  of  the costs associated with a retail sales effort. It is
  100.          good for you since it allows you to make an  intelligent  buying
  101.          decision  by  trying  the  program to make sure it does what you
  102.          want before you spend your money. It does however bring with  it
  103.          a legal and moral commitment to buy (Register) the program after
  104.          you have tried it and found it to be to your liking. The authors
  105.          of  Shareware  receive  NO  money from the distribution of their
  106.          efforts until you, the user, register it.  If  you  believe  the
  107.          effort  that  goes  into writing a program such as this deserves
  108.          the thirty-five dollar registration fee then please  register by
  109.          sending  your  check  along with the form included at the end of
  110.          the documentation. 
  111.          
  112.          No program features have been "held back" until you register the
  113.          program.  When you register, you will receive a copy of the lat-
  114.          est version of the program as well as discounts  on  any  future
  115.          program  upgrades.  In addition, you will be kept informed about
  116.          several other programs in development on related subjects. Prog-
  117.          gram support will be provided to both non-registered and regist-
  118.          ered users using Compuserve Mail addressed to  Edward J. Panner,
  119.          (72717,1612) or by U.S.Mail addressed to Edward J. Panner at the
  120.          registration address.
  121.  
  122.          This program is produced by  a  member  of  the  Association  of
  123.          Shareware  professionals  (ASP). ASP wants to make sure that the
  124.          shareware principal works for you. If you are unable to  resolve
  125.          a  shareware related problem with a ASP member by contacting the
  126.          member directly, ASP may be able to help. The ASP Ombudsman  can
  127.          help  you  resolve  a dispute or problem with an ASP member, but
  128.          does not provide technical support for members' products. Please
  129.          write  to  the  ASP  Ombudsman  at 545 Grover Road, Muskegon, MI
  130.          49442 or send a Compuserve message via Compuserve  Mail  to  ASP
  131.          Ombudsman 70007,3536. 
  132.          
  133.          Additional  information about the legalities of Shareware may be
  134.          found in the appendix to this documentation. 
  135.  
  136.          MARNAV has a data base of thirteen files, one for  each  of  the
  137.          thirteen chains world wide. The Shareware version is distributed
  138.          with only one of these, the Pacific Coast Chain (GRI 9940) which
  139.          will  let  you  try all of the programs features. In addition to
  140.          these data files, one file is maintained to indicate the  Active
  141.          Chain  (The chain you are currently using). When you first bring
  142.          up MARNAV, it will read this active chain file and then the data
  143.          for  the  indicated  chain. It is necessary that the program and
  144.          all of the data files be kept in the same  directory  since  the
  145.          program  looks for its data files in whatever directory you were
  146.          in when you first brought up the program!
  147.  
  148.  
  149.          MARNAV                   Documentation                   Page- 3
  150.  
  151.  
  152.          
  153.          The first screen gives the title and copyright data as well as a
  154.          message  indicating what Active GRI data has been loaded. At the
  155.          bottom of the screen is the main  menu.  You  will  be  able  to
  156.          return  to  this  menu from virtually anywhere in the program by
  157.          pressing the <HOME> key. In some cases you may also use the  <M>
  158.          key  as  indicated  on the screen at that time. Each of the menu
  159.          selections will be discussed below. Use the arrow keys  to  move
  160.          around  the  menu selections. When the blinking cursor is at the
  161.          end of any menu selection, the <RETURN>  key  will  select  that
  162.          menu choice.
  163.          
  164.                                     Section II
  165.          
  166.                                  LORAN >> LAT/LON-
  167.          
  168.          As  the  menu  suggests,  when you make this choice, the program
  169.          will convert Loran delay data  to  Latitude/Longitude  position.
  170.          You  may  enter  delay data for any two secondaries. The program
  171.          will not only calculate and report your Latitude/Longitude posi-
  172.          tion  but will also calculate the remaining secondary delays for
  173.          that position. This may at times be very useful since  secondar-
  174.          ies do fail and it may be necessary to choose another.
  175.          
  176.          A  number  of  comments  are in order at this point. Since Loran
  177.          positioning depends on the intersection of two Hyperbolic  delay
  178.          lines,  there  are two valid intersections with the same delays.
  179.          These are usually far enough apart so they do  not  confuse  the
  180.          user but the computer does not know which one you are interested
  181.          in and so may well calculate the other position. To avoid  this,
  182.          it  is  necessary  to  provide  the computer with an approximate
  183.          latitude and longitude position. Generally anything within a few
  184.          hundred  miles  is  close enough. (2 to 3 degrees) Those are the
  185.          numbers appearing at the top right of this screen. They  may  be
  186.          changed by pressing <END> in the conversion routines or by using
  187.          the utilities and that will be discussed in a later section.
  188.          
  189.          Notice that the Latitude/Longitude  data  is  printed  in  three
  190.          formats: Degrees and decimal Degrees; Degrees, Minutes and deci-
  191.          mal Minutes; Degrees, Minutes, Seconds and decimal Seconds. This
  192.          is  done since different charts and maps have grids given in any
  193.          one of these three formats depending on the scale.
  194.  
  195.          In  normal  geographic  position  data, West Longitude and South
  196.          Latitude are negative values. In order  to  avoid  the  inconve-
  197.          nience of worrying about the sign of these numbers, the quadrant
  198.          data near the top center of the  screen  defines  the  quadrants
  199.          which  are defined with positive values. For example, the United
  200.          States is in the North latitude quadrant and the West  Longitude
  201.          quadrant. Consequently, these Lat/Lon numbers are given as posi-
  202.          tive values. The quadrants selected may also be changed  in  the
  203.          same way as are the approximate latitude and longitude by press-
  204.          ing the <END> key in the conversion routines.
  205.  
  206.  
  207.          MARNAV                   Documentation                   Page- 4
  208.  
  209.  
  210.          
  211.          If the entered delays are unrealistically far from the  Approxi-
  212.          mate Lat/Lon entries you will get a message:
  213.          
  214.                   NO USEFUL SOLUTION-CHECK INPUT DATA". 
  215.                                                        Press any  key  to
  216.          return to the Main Menu.
  217.          
  218.          We  will  defer  discussion  of the "INCLUDED CORRECTION" column
  219.          until the Utilities are discussed in a later section.
  220.          
  221.                                     Section III
  222.          
  223.                                   LAT/LON >> LORAN
  224.          
  225.          This menu choice lets you convert Lat/Lon data to Loran  delays.
  226.          The  Quadrant data and the Approximate Lat/Lon have already been
  227.          discussed in the previous section. Also discussed in  that  sec-
  228.          tion  were  the three formats used for Lat/Lon data output. Data
  229.          may also be input in any of these three formats and the  compute
  230.          will calculate the remaining two forms. This is a useful feature
  231.          if you need to convert from one format  to  another  when  using
  232.          different scale charts.
  233.          
  234.          If you enter data as follows:
  235.                    42.62 it will be accepted as format 1
  236.          Format 2 may be entered in any of these ways:
  237.                    43/45.2 or 43:45.2 or 43,45.2 or 43 45.2
  238.          It  does not matter if you type a , or a / or a space or a colon
  239.          as the delimiter, on the screen each of these forms would appear
  240.          as 43/45.2.
  241.          
  242.          Format  3  allows  the  same  delimiters  and  the data might be
  243.          entered as follows:
  244.                   43/50/34.6 or 43:50:34.6 or 43,50,34.6 or 43 50 34.6
  245.          
  246.          As  before,  no  matter  how you enter it, on the screen it will
  247.          look like the first example 43/50/34.6.
  248.          
  249.          Once the Lat/Lon data is entered the Approximate Lat/Lon data is
  250.          temporarily  changed to conform and the calculation is completed
  251.          for all of the secondaries in the chain.
  252.  
  253.          CAUTION!  JUST BECAUSE THE COMPUTER TELLS YOU WHAT THE DELAY FOR
  254.          THAT POSITION WILL BE, IT MAY BE THAT YOU ARE SO FAR FROM A SEC-
  255.          ONDARY STATION THAT YOU MAY NOT BE ABLE TO RECEIVE IT!
  256.          
  257.          As  mentioned  in  the previous section, the INCLUDED CORRECTION
  258.          column will be discussed later.
  259.   
  260.    
  261.          MARNAV                   Documentation                   Page- 5
  262.  
  263.  
  264.          
  265.                                     Section IV
  266.          
  267.                                  BEARING/DISTANCE
  268.          
  269.          The Bearing/Distance option  will  calculate  the  heading  from
  270.          point  A to point B, it will give the distance in Nautical miles
  271.          and the reciprocal heading. (The  heading  from  B  to  A).  The
  272.          points  may  be specified in either Lat/Lon or Loran delays. One
  273.          may defined in one way while the second is defined in the other.
  274.          If,  when the cursor is at the LOP1 (Delay 1 or Line of Position
  275.          1), you press the <ENTER>  key  the  program  assumes  you  will
  276.          specify  the position in Lat/Lon coordinates. The cursor is then
  277.          positioned on the ENTER LATITUDE line.
  278.          
  279.          If you enter either position in Loran delays the  Lat/Lon  posi-
  280.          tion  is  calculated;  If,  however,  you  enter the position in
  281.          Lat/Lon coordinates, the Loran delays will  not  be  calculated.
  282.          This section should require no further discussion.
  283.          
  284.                                     Section V
  285.          
  286.                                SPEED/TIME/DISTANCE
  287.          
  288.          Little  comment  is  required  for  this  choice.  The  computer
  289.          calculates the relationship between these three variables. Enter
  290.          any  two  and  it will calculate the third. Simply press <ENTER>
  291.          for the one you want the solution for. If  the  distance  is  in
  292.          Nautical  miles, the speed given will be knots, or conversely if
  293.          speed is entered in knots, calculated distance will be in nauti-
  294.          cal  miles.  IF speed is miles per hour distance will be statute
  295.          miles.
  296.          
  297.          If time is being calculated, the result is given in  both  Hours
  298.          and decimal hours as well as hours and minutes. If time is being
  299.          entered the same formats as discussed in Section III for degrees
  300.          and  minutes, etc. hold for time, which may be entered in hours,
  301.          minutes and seconds using the same delimiters of "/"  ","    ":"
  302.          or space.
  303.  
  304.                                     Section VI
  305.          
  306.                                     GRI UTILITIES
  307.          
  308.          The GRI Utilities allow you to enter data for a new Loran Chain,
  309.          let you edit all of the data for Loran Chains you  already  have
  310.          in  files,  provide  an additional way to change the Initial GRI
  311.          (The GRI which comes up when you load the program), let you  add
  312.          correction  factors  for  each secondary and will print the data
  313.          file for any Loran Chain.
  314.  
  315.  
  316.          MARNAV                   Documentation                   Page- 6
  317.  
  318.  
  319.          When  you  select the EDIT option you have the choice of editing
  320.          the data currently in memory, reading a new GRI file for edit or
  321.          starting  over  to  enter a new Loran Chain. Editing is straight
  322.          forward. You can move around the data  screen  using  the  arrow
  323.          keys. If you press the <ENTER> key the program accepts the entry
  324.          as it appears on the screen. To edit a data  entry,  the  entire
  325.          entry  must  be  retyped.  When you have finished correcting the
  326.          data field, press <END> to return to the menu bar.  If  you  are
  327.          satisfied  with the field as it exists, move the cursor to WRITE
  328.          FILE-, press <ENTER> and the data will be written to disk.
  329.          
  330.          If you selected the CHANGE GRI- option from the  EDIT  menu  the
  331.          new  data will replace the data you have been using. You can now
  332.          exit Edit and work in the new GRI or, you may want to edit  that
  333.          data  and  write  it  to the files. If, at that time you want to
  334.          change back to the GRI you had previously, you will have to  use
  335.          the CHANGE GRI- option again and call for the desired Chain.
  336.          
  337.          If  you  are  entering  data for a new Loran Chain, latitude and
  338.          longitude data must be entered in the degree and decimal  degree
  339.          mode only. Double check all of your entries carefully because an
  340.          error here produces erroneous output. When all the data has been
  341.          entered, write the data to disk using the WRITE FILE- option.
  342.          
  343.          When you want to change the Initial GRI, select that option from
  344.          the Utilities menu bar. The cursor will move to the  upper  left
  345.          portion  of  the screen. You then enter the new GRI designation,
  346.          along with the Latitude and  Longitude  quadrants  you  will  be
  347.          working  in.  (See Section II). When you press <ENTER> after the
  348.          longitude quadrant selection, the new GRI  file  will  be  read.
  349.          After that whenever you start the program, the data for the Ini-
  350.          tial GRI will be loaded automatically.
  351.          
  352.                                     SECTION VII
  353.          
  354.                                  CORRECTION FACTOR
  355.          
  356.          Loran calculations and their accuracy depend on the  propagation
  357.          velocity  of radio waves. Unfortunately the propagation velocity
  358.          is not the same over all types of terrain so the delay time to a
  359.          given  point  may  be  slightly  different than it is to another
  360.          point whose distance from the secondary station is  exactly  the
  361.          same.  While the errors incurred are not large, they can lead to
  362.          position errors of one quarter to one third of a mile.
  363.          
  364.          If you get the exact geographic location of  some  fixed  object
  365.          such  as  a bridge, a building or a point of land you can calcu-
  366.          late the theoretical Loran delays for that  point.  If  you  now
  367.          measure  the actual delays to that point using a Loran, the dif-
  368.          ference between the calculated delays and  the  measured  delays
  369.          can be entered as correction factors.
  370.  
  371.  
  372.          MARNAV                   Documentation                   Page- 7
  373.  
  374.  
  375.          These correction factors will be approximately correct  for  all
  376.          Loran data in the general area where they were determined. These
  377.          correction factors will have a negative value because the propa-
  378.          gation   velocity   of  radio  waves  is  decreased  by  surface
  379.          anomalies. These correction factors may be entered for each sec-
  380.          ondary  using  the  editor in the GRI UTILITIES mode. It is this
  381.          propagation velocity problem that results in the Absolute  Posi-
  382.          tion  Error  in Lorans even though Repeatable Accuracy may be as
  383.          little as 50 feet. The correction factors help to  resolve  this
  384.          difficulty when precise positioning is important.
  385.          
  386.          Do  not  use  the chart position of markers or bouys from marine
  387.          charts since their geographic position  is  often  significantly
  388.          different  from  their  position on the chart. Land based points
  389.          whose position is determined by surveys are  more  suitable  for
  390.          calculating correction factors.
  391.          
  392.                                    Section VIII
  393.          
  394.                                 HARD COPY-OFF or ON
  395.          
  396.          It  is  often convenient to have a hard copy of your conversions
  397.          or, more often, the calculations of heading and  distance.  This
  398.          is especially true when you are planning a boat cruise since you
  399.          can plan your entire trip in the comfort of your home or  office
  400.          and  have a printout of the results. The HARD COPY OFF/ON option
  401.          of the main menu toggles the printer on  and  off  whenever  the
  402.          cursor is positioned at this choice and you press <ENTER>. After
  403.          each of your conversions or calculations, the results are  auto-
  404.          matically printed.
  405.  
  406.  
  407.          MARNAV                  Documentation                   Page- 8
  408.  
  409.                                    Appendix
  410.  
  411.          
  412.          
  413.          
  414.                                  Shareware
  415.          
  416.          Copyright laws apply to both Shareware and commercial  software,
  417.          and the copyright holder retains all rights, with a few specific
  418.          exceptions as stated below. The author specifically  grants  the
  419.          right to copy and distribute the software, either to all or to a
  420.          specific group. 
  421.          
  422.           Shareware is a distribution method, not a type of software. You
  423.          should  find  software  that  suits  your  needs and pocketbook,
  424.          whether it's Commercial or Shareware. The Shareware system makes
  425.          fitting  your  needs easier, because you can try before you buy.
  426.          And because the overhead is low, prices are low also.  Shareware
  427.          has  the  ultimate  money-back guarantee -- if you don't use the
  428.          product, you don't pay  for  it.  Shareware  distribution  gives
  429.          users  a  chance  to try software before buying it. If you try a
  430.          Shareware program and continue using it,  you  are  expected  to
  431.          register. 
  432.          
  433.          MARNAV.EXE is a "shareware program" and is provided at no charge
  434.          to the user for evaluation. Feel free  to  share  it  with  your
  435.          friends,  but  do not give it away altered or as part of another
  436.          program. The essence of "user-supported" software is to  provide
  437.          personal  computer  users  with  quality  software  without high
  438.          prices, and yet to provide incentive for programmers to continue
  439.          to  develop  new  products.  If you find this program useful and
  440.          continue  to use it after a  reasonable  trial period,  you must
  441.          make a registration payment of $35.00 to C & E Associates 
  442.          
  443.           The registration fee will license one copy for use on  any  one
  444.          computer at any one time. You must treat this software just like
  445.          a book. An example is that this software may be used by any num-
  446.          ber of people and may be freely moved from one computer location
  447.          to another, so long as there is no possibility of it being  used
  448.          at one location while it's being used at another. Just as a book
  449.          cannot be read by two different persons at the same time. 
  450.          
  451.          Anyone distributing MARNAV.EXE for any kind of remuneration must
  452.          first  contact  C  &  E  Associates  at  the  address  below for
  453.          authorization. This authorization will be automatically  granted
  454.          to  distributors  recognized  by  the  (ASP)  as adhering to its
  455.          guidelines for shareware distributors, and such distributors may
  456.          begin offering MARNAV.EXE  immediately (However C & E Associates
  457.          must still be advised  so  that  the  distributor  can  be  kept
  458.          up-to-date with the latest version.) 
  459.  
  460.  
  461.          MARNAV                   Documentation                   Page- 9
  462.  
  463.        
  464.          You are  encouraged  to  pass a copy of MARNAV.EXE along to your
  465.          friends for evaluation. Please encourage them to register  their
  466.          copy  if  they  find  that they can use it. All registered users
  467.          will receive a copy of the latest version of the MARNAV programs
  468.          as well as the data files for all existing LORAN chains.
  469.  
  470.          The  distribution of MARNAV.EXE by shareware vendors  and  other
  471.          distributors of user supported software  is  hereby  authorized.
  472.          MARNAV.EXE  is  copyrighted  software and is not placed  in  the
  473.          public domain but rather is entered in the Shareware  market  so
  474.          that potential users may insure that it meets their needs.
  475.          
  476.          The registration fee  for the program  is a only  $35.00.   Reg-
  477.          istered users will automatically receive  software  support  and
  478.          notice of any program enhancements. Any future new versions will
  479.          be made available to registered users for a nominal fee.
  480.          
  481.          
  482.          
  483.          ______________________________________________________________
  484.          
  485.          
  486.                                  Registration Form
  487.  
  488.                                      MARNAV.EXE
  489.          
  490.          
  491.               Name ____________________________________________
  492.          
  493.          
  494.               Street __________________________________________
  495.          
  496.          
  497.               City/State ______________________________________
  498.          
  499.          
  500.              Please enclose the $35.00 registration fee and mail to:
  501.          
  502.                                  C & E Associates
  503.                                  119 Placid Drive
  504.                                   Fort Myers, FL
  505.                                        33919
  506.          
  507.                                          Thank you for you support,
  508.                                                  Ed Panner
  509.           
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.